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All Rights Reserved 


COPYRIGHT NOTES 


This manual and the object code (contained on floppy disk) ie 
serial mumbered and protected by a legitimate copyright. No part of 
this manual may be copied or reproduced without the express written 
permission of the copyright owner, Eastern House Software. You may 
make a backup copy of the diskette in order to protect your copy of 
thie software. It is though a Federal crime to make a copy of the 
manual or floppy disk for use by anyone other than the individual who 
purchased thie software or the individual a company purchased the 
software for. 


Thus, you are in violation of Federal Copyright Laws if you do 
one of the following: 


~ Make a copy of the manual. 

- If you allow someone else to use your copy (or backups) 
of the object media (diskette) while you retain a copy 
or are using a copy. 

- If you, your company, or others purchase one or more 
copies and more individuals simultaneously use this 
software than the number purchased. 

- If you allow someone else to do the copying of this 
material, you will be considered as a party to the 
infringement. 


A reward will be provided for anyone supplying information which 
leads to the prosecution of parties who violate this copyright. 


We do not presume that you are or will violate copyright laws. 
Most users do not. Some though do, and may not realize the 
consequences for violation of this Federal Law. Penalities and fines 
can be quite severe for both individuals and companies who infringe 
this copyright. 


Most importantly, software houses like the one which wrote this 
software have incurred a tremendous investment that can not be fully 
recovered if current illegal copying continues. Also, updates and 
progran maintenance wili have to be terminated if the return on 
investment is not sufficient. 


Finally, an Sipeaanie appreciation is given to the purchaser of 
this software. We hope that you find it a valuable ard worthwhile 
investment. my | 


If you encounter any problems, contact us at: 


Eastern House Software | 
Carl Moser Don Earnhardt 
3239 Linda Drive or 2130 Nettlebrook Dr. 
Winston-Salem, N. C. 27106 Winston-Salea, N. C. 27106 
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1. INTRODUCTION 


This Macro Assembler (ASSM) and Text Editor (TED) resides 
simultaneously in approximately 11K bytes of memory (5000-7C80). The 
collective assembler and text editor is referred to as MAE. MAE was 
designed to work with the 48K Apple II or Apple II Plus microcomputer 
and Disk II. 


As mentioned, the MAE object code occupies just over 11K of 
memory. In addition to this, sufficient memory must be allocated for 
the text file and label file (symbol table). Approximately 8K is 
sufficient memory for the text file for small programs or larger 
programs if assembled from disk. If an executable object code file 
is to be stored in memory during assembly, sufficient memory must be 
provided for that also. On cold start entry ($5000), MAE will set 
the file boundaries as follows: 


— Text File | = §3000-S4FFC 282 SO TFS 
-- Label File = $1800-S2FFC ‘):- '< > 
-- Relocatable Object Buffer = $7800 , 
($7800 1s a buffer provided internally to MAE) 
ana C149 yet BPSD. 

These boundaries leave memory for other language programs at 
$0800 - S$17FC and at $7C80 - $95FC. The label file and text file 
that MAE generat:es is position independent and may be _ located 
practically anywhere in RAM memory. The object code file location is 
dependent on the beginning of assembly (.BA pseudo op) and the _ .MC 
pseudo op. 


Fear not the accidental reset! The MAE contains reset protection 
which executes a warm start when the reset key is pressed. This 
prevents any loss of data if an accidental reset occurs. 
Additionally, if you exit the MAE to the monitor or to Basic, the 
reset key will cause a return to that particular language. In order 
to return to the MAE, perform a warm start (see Part 11). The 
previous text file should remain in tact. 


MAE was designed such that records in the label file and text 
file are variable in length and directly dependent on the number of 
characters to be stored. This results in more efficient utilization 
of memory. Some unique features of MAE are: 


— Coexists with Apple Basic. 

-~ Macro, Conditional Assembly, and Interactive Assembly. 

-- Labels up to 31 characters in length. 

~~ Auto line numbering for ease of text entry. 

-- Creates both executable code in memory and relocatable 
object code on disk. 

-- Manuscript feature for composing letters and other text. 

-- Loading and Storing via Disk. 
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-——- Supports various printer arrangements 

-- String search and replace capability, plus other powerful 
editing commands. | 

-- Capability to send command strings to Apple II Disk. 


MAE uses a prompter character: ). This parens character is used 
to indicate that MAE is ready to accept commands. Command mnemonics 
referenced in this document are printed with the prompter (example 
)BR). When inputting a command, you should not type ")” preceeding 
the mnemonic. 


Initial entry (or cold start) to MAE is at address $5000. If 
the break command, )BR, is executed, one may reenter MAE at $5003. 
Initial entry provides the following default parameters: 


-—- Format = set 

-- Manuscript = clear 

—- Auto line numbering = off 

-~- Text file and Label file = clear 


MAE was designed to coexist with Apple Basic. This was 
accomplished by preserving Basics zero page variables. Thus, on cold 
start entry, MAE copies $98 - S$FF of zero page to a save area 
($7698-$76FF). On all exits (via )BR, )RU, )US), MAE restores these 
variables. On warm start entry, MAE swaps zero page with the save 
area. MAE also uses a number of absolute variables at $7700-$7/FF. 


You should protect MAE from Basic by setting the Basic variable 
HIMEM ($73, $74) to point to just below MAE and its text and label 
files. For example, to protect memory above $1800, enter $00 at 
location $73 and $18 at location $74. 


This software has been extensively tested and is believed to be 
entirely reliable. It would be foolish to guarantee a program of 
this size and complexity to be free of errors. Therefore, we assume 
no responsibility for the failure of this software. 


MAE is protected by a Copyright. This material may not be 
copied, reproduced, stored in a retrieval system, or otherwise 
duplicated without the written permission of the owner, Carl Moser. 


The purchaser may however make copies of the diskette for his own 
individual use for backup purpose. The purchase of this software 


does not convey any license to manufacture, modify and/or copy this 
product in any manner. 
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2. FILES CONTAINED ON THE DISKETTE 


The supplied diskette contains the following files: 


Filename Description 

MAE .EXE MAE object code 

RELOC .EXE Relocating Loader object code 
RELOC.REL Relocating Loader relocatable code 
MAE.NOT * Some notes on MAE 

WORDP -.EXE Word Processor Program 

WORDP.INS * Word Processor Instructions File and 


example of raw text 


MLMACROS .MLIB * File of some Machine Language Macros 
SWEET16.MLIB * File of SWEET16 Macros 
UART.CTL * Example program control file 
UART.MO1 * Example program modules 
UART .MO2 (UART Driver) 
UART .MO3 
PARL. OUT .EXE Parallel printer driver 
TEXTOUT . SOURCE * program to convert MAE files to text files 
_ TEXTOUT .EXE Textfile program 


* = Source files in MAE format. 


3. TEXT EDITOR (TED) FEATURES 


The TED occupies approximately one-half the total memory space 
of this software. The purpose of the TED is to setup and maintain 
the source file by interacting with the user via various commands. 


When inputting to the TED, the user has available the full 
capabilities of the built-in Apple II screen editor. 


When listing to the CRT or printer, the user has control of the 
output via the following keys. 


Control S =- Temporarily halt outputting and await input of one of 

the following keys. 
Control Z - Return to ”)” level. ; 
Control 0 = Continue processing but suppress output except for 

errors. 
Control Q =- Continue outputting after control S. 
Control C — Exit to Apple monitor OSG. 
Control B - Exit to Basic CALL 204§3 


' 
H 
1 


[ORE HT 
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A. Commands 


The TED provides 27 command functions. Each command mnemonic 
must begin immediately after the prompter (")"). When entered, a 
command is not executed until a carriage return is given. Although a 
command mnemonic such as )PR may be several nonm-space characters in 
length, MAE only considers the first two. For example, )PR, )PRI, 
)PRINT, and )PRETTY will be interpreted as the print command. 


Some commands can be entered with various parameters. For 
example, )PRINT 10 200 will print out the text in the text file with 
line numbers between 10 and 200. One must separate the mnemonic and 


the parameters from one another by at least one space. Do not use 
commas. 


A disk filename may be specified in some of the following 
commands. Wherever ‘file’ is given as a command parameter, its 
format is as follows: 


where: n is the disk Drive/Slot number (default = 16 for 
drive I, slot 6 - i.e. D16) 
name is the file name 


Examples are: D16 “MAE.NOT” 
D26 “RELOC.REL” 
“DOS SUPPORT” 


A description of each command follows: 


-)ASSEMBLE “FILE” w 


If file is specified, load the file into text area and If no 
file specified, then assemble contents of text area. 


If w=LIST then generate a listing. If w=NOLIST or w not entered 
then an errors only output will be generated. 


JAUTO x 


Begin auto line numbering mode with next user entered line 
number. x specifies the increment to be added to each line nuaber. 
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You may exit auto line numbering by entering // immediately following 
the prompted line number. 


) BASIC 


Restore zero page and go to Basic. 


) BREAK 


Restore zero page and go to Monitor. 


)CLEAR 


Clear text file. 


)COPY xy z 


Copy lines y thru z in the text file to just after line number 
x. The copied lines will all have line numbers equal x. At 
completion, there will be two copies of this data - one at x and the 
original at y. 


JDC “command” 


Pass disk commands to Apple DOS. Any DOS command that can 
normally be entered as a direct command may be passed. 


‘Example: Output catalog is )DC “CATALOG” 
Delete file TEST is )DC “DELETE TEST” 


)DC “@filename” 


Apple MAE generates two binary files for each source file saved 
on the disk. These files are represented in the catalog as 
‘filename’ and ‘filename*'. The file with the trailing asterisk in 
ites name is used by MAE to calculate the length of the actual source 
file during loading. MAE uses this as a safeguard to prevent you 
from loading a file larger than the boundaries allocated for the text 
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file. If the file is larger than allocated memory, MAE will not load 
it but instead issue a !OF error. 


To summarize, )DC "@filename” command is used when it is desired 
to delete both entries in the directory (including the filename* 
file). 


)DELETE x y 


Delete entries in the text file between line numbers x and y. 
If only x is entered, only that line is deleted. 


JEDIT t Slt S2et OR EDIT a 


String search and replace, or interline edit. See Part 7. 


)FIND t¢ Slt 


String search. See Part 7. 


)FORMAT w no 


eo 


Format the text file (where w=SET) or clear the format feature 
(where w=CLEAR). Format set tabulates the text file when outputted. 
This lines up th 


mn specifies the number of characters per label (max. = 31). 
This is used to tabulate the listing. 


)GET “file” y 


Get file from disk and store in the text buffer. If y is not 


entered, store at start of text buffer. If y is a line number, enter 
following specified line number. If y = APPEND then enter following 
current contents of text file. 


Examples: §)GET “MEMTEST™ 


)GET D16 “CRTDVR" 1000 
)GET D27 “UART” APPEND 
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)HARD w x 


Format for hard copy listing. This feature is designed to work 
with 66 line pages and leaves margin at top and bottom along with 
page number. )HA SET turns this feature on, )HA CLEAR turns this 
feature off. x is the starting page number. )HA PAGE advances to 
top of next page. 


Each time )HA SET is entered, MAE resets its internal line 
counter to 0. Thus, you must manually adjust the paper in the 
printer so MAE and the printer are synced. 


)LABELS w 


Print out the entire contents of the label file if weALL or w 
not entered. Print only fixed (external) labels 1f w=FIXED. Print 
only internal or program labels if w=PROGRAM. 


)MANUSCRIPT w 


If wSET, line numbers are not outputted when executing the )PR 
command. If w=CLEAR, line numbers are outputted when the )PR command 
is executed. Assembly output ignores the )MA command. If manuscript 
is to be generated using MAE, manuscript should be set and format 
clear: )MA SET, )FO CLEAR. Since the TED considers a blank line a 
deletion, you may insert a blank line by entering a line with a 
single period. When printed, a blank line will be output. 


)MOVE x y 2 


Move lines y thru z in the text file to just after line number 
x. The moved lines will all have line numbers equal to x. The 
original lines y thru z are deleted. )NUMBER x y 
JOY ber the text file starting at line x in the text file and 
expanding by constant y. For example, to renumber the entire text 
file by 10, enter )NU 0 10. 
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JOUTPUT “file” 


Create a relocatable object file on disk. This command uses the 
256 byte relocatable buffer that can be reallocated via the SET 
command. 


)PASS “file” 


Execute second pass of assembly. First pass must be previously 
performed. If filename is entered in the )PASS command, then the 
text file is loaded before executing the second pass, else )PASS will 
assume the file is in the text area. 


YPRINT x y 


Print the text file data between line number x and y on the CRT, 
If only x is entered, only that line is printed. If no x and y, the 
entire file is printed. : 


ae - ie 
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put “file” x y 


Te 


scitemeeevoeee 


“pitt text file between lines x and y to disk. If x and y are not 
entered, the entire text file will be put to disk. 


RUN label 


Run (execute) a previously assembled program. If a symbolic 
label is entered, the label file is searched for the atarting” 
address. The called program should contain an RTS instruction as the 
last executable instruction. . 


)SET ts te ls le ba 


If no parameters are given, the text file, label file, and 
relocatable buffer boundaries (addresses indicating text file start, 
end, label file start, end, and relocatable buffer start) will be 
output on the first line. On the second line the output consists of 
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the present end of data in the text and label file. This command is 
commonly used to determine how much memory is remaining in the text 
file. If you are inputting hex digits for these addresses, preceed 
each with a ‘'$' character. 


If parameters are entered, the first two are text file start 

58} and end (te) addresses, then the label file start (1s) and end 

le) addresses, and finally the relocatable buffer start address 
(bs). 


Caution should be used not to set either the text file or label 
file boundaries to $800. This conflicts with Basic. 


)TI wn (See Part 9) 


Assign terminal input (keyboard) as Apple if w=Apple, or serial 
device if w=SERIAL. Both input and output will be assigned to the 
serial device if w=TERMINAL. If entered, n is the number of pad bits 
to be sent on occurrance of carriage return. 


When )TI SERIAL or )TI TERMINAL is entered, you must type S on 
the serial keyboard so MAE can determine the baud rate of the device. 
Permissable baud rates are 110, 300, 600, 1200, 2400, 4800, 7200, and 
9600. After you type S, press the return key. If MAE receives a 
valid carriage return character, control is then transferred to the 
serial device. If a valid carriage return is not received, control 
will remain with the Apple. 


)TO w nm (See also Part 9) 


Assign terminal output (CRT or printer) as: Apple screen if 
W*APPLE, or printer (thru MAE printer driver if w=PRINTER. If 
w=SERIAL then output will be directed thru the MAE software UART 
driver (See Part 9). If w=ALL then output will be directed thru both 
the printer vector and and the software UART. 


If you are using a standard Apple printer interface, then 
instead enter )DC “PR#n” to turn on your printer (see Part 15). 


If you do not have a standard Apple II printer, you may insert a 
JSR to your printer driver at $791B. Currently this is configured 


for use with the popular Heath H14 printer. 
If w = SERIAL or ALL, then a is the baud rate code and a is the 


number of pad bits on occorrance of carriage return. The baud rate 
code (n) is as follows: 
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baud rate 


110 
300 
600 
1200 
2400 
4800 
7200 
9600 


NQAU & WwW PP Oo 


)USER 


Restore zero page and go to location $0000. You must have 
entered a JMP instruction at that address. Note that BASIC defaults 
$0000 to point to its warm start entry. 


B. Entry/Deletion/Change of Text 


Source is entered in the text file by entering a line number 
(0-9999) followed by the text tc be entered. The line number string 
can be one ton digits in length. If the string is greater than 4 
digits in length, only the right-most 4 are considered. Text may be 
entered in any order but will be inserted in the text file in 
numerical order. This provides for assembling, printing, and 
recording in numerical order. Any entry consisting of a line number 


with no text or just spaces results in a deletion of any entry in the 
text file with the same line _ number. If text is entered and a 


corresponding line number already exists in the text file, the text 
with the corresponding number is deleted and the entered text is 
inserted. 


To delete the entire file, use the )CL command. 


To delete a range of lines, use the )DE command. To edit an 
existing line or lines having similar characteristics, use the )ED 
command. 


To alter an existing line, use the )ED command fora 2. 


To find a string, use the )FI command. To move or copy lines 
use the )MO or )CO commands. 


To insert a blank line, enter a line with just a period (.). 
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Text may be entered more easily by use of the auto line 
numbering feature (via )AU command). Any )AU x where x does not 
equal 0 puts the TED in the auto line number mode on the next entry 
of a line number. To exit from this mode, type )//. 


When entering source for the assembler, one need not space over 
to line up the various fields. Labels are entered immediately after 
the line number. Separate each source field with one or more spaces. 
If the format feature is set (see )FO command), the TED will 
automatically line up the fields. Note: If a space is entered before 
the label, the TED will line up the label in the next field. This 
should result in an assembler error when assembled. Commands, 
mnemonics, and pseudo ops may be entered as upper case or lower case 
characters. Labels in the program may be entered as upper or lower 


case characters but a label entered as upper case will be unique to 


the same label entered as lower case- 


4. ASSEMBLER (ASSM) FEATURES 


The ASSM scans the source program in the text file. This 
requires at least 2 passes (or scans). On the first pass, the ASSM 
generates a label file (or symbol table) and outputs any errors that 
may occur. On the second pass, the ASSM creates an optional listing. 


A third pass (via )OU), may be performed in order to generate a 
relocatable object file of the program in the text file. This file 


ie recorded on disk and may be relocated at the users descretion 
practically anywhere in memory. 


A- Source Statement Syntax 
Each source statement consists of 5 fields as described below: 


Jline number label mnemonic operand comment 


Label: 
The first character of a label may be formed from 
the following characters: 
@ AthruZ [ ] 


While the remaining characters which form the label 
may be constructed from the above characters and the 


following characters: 
« F @ tere dS ¢ 2 4.2 2% 


The label is always entered immedi at ely after the line 
nuaber. 
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Mnemonic (or Pseudo Op): 
The mnemonic or pseudo op is separated from the label 


by one or more spaces and consists of a standard 
6502 mnemonic of table A, pseudo op of table B, or macro name. 


Operand: 
The operand is separated from the mnemonic or pseudo op 
by one or more spaces and may consist of a label 
expression from table C and symbols which indicate 
the desired addressing mode from table D. 


Comment: 
The comment is separated from the operand field by one 
or more spaces and is free format. A comment field ~~ 
ns more spaces past the mnemonic or pseudo op 
if the nature of such does not require an operand field. 
A free format comment field may be entered if a 
semicolon (;) immediately follows the line number. 


NOTE: It is permissable to have a line with only a label. 
This is commonly done to assign two or more labels to 
the same address. If the line has only a label or 
label with comment, then the label may be any length 
up to 79 characters regardless of the label length 
set with the )FORMAT command. 
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TABLE A — 6502 Mnemonics 


(For a description of each mnemonic, consult the 6502 
Software Manual) 


ADC CLD LDA SBC 
AND CLI LDX SEC 
ASL CMP LDY SED 
BCC CPX LSR SEI 
BCS _ CPY CLV STA 
BEQ | DEC ORA STX 
BIT DEX PHA STY 
BMI DEY PHP NOP 
BNE EOR PLA TAX 
BPL INC PLP TAY 
BRK INX ROL TSX 
BVC INY ROR TXA 
BVS JMP RTI TXS 
CLC JSR RTS TYA 


TABLE B = Pseudo Ops 


eA7 


Store Ascii strings in Apple format (bit 7 = set). The input 
format is .A7 ‘this string is in Apple format'. refer to the .BY 
pseudo op for further details. | 


«BA label exp. 


Begin assembly at the address calculated from the label 
expression. This address must be defined on the first pass or an 
error will result and the assembly will halt. 


“+ ose 


Sa a ae 


NOTE: When BA, MC, and .OS are used in a file, they must be used in sO 
this order. 
a 
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- BY 


Store bytes of data. Each hex, decimal, or binary byte must be 
separated by at least one space. An ascii string may be entered by 
beginning and ending with apostrophes ('). Example: .BY 00 ‘ABCD’ 47 
69 'Z* SFC Z1101 } 


In order to insert consecutive blank spaces in an Ascii string 
using a .A7 or .BY pseudo op, you must enter two apostrophes and a 
single space prior to the string. Example: .A7 ‘'-' ABC’ (= 
represents a space character). 


CE 


Continue assembly if errors other than !07, 104, and !17 occur. 
All error messages will be printed. 


-CT 


Designate current contents of text buffer as a control file. 


Only one control file may exist during each assembly. Designation as 
a control file allows the use of .FI pseudo ops to link other files 


for the assembly process. 


Note: Only one .EN pseudo op is allowed in each 

; assembly and if .CT is used, the .EN aust be 
at the end of that file. Thus, files referenced 
via .FI must oot have a .EN pseudo op. 


label .DE label exp. 
Assign the address calculated from the label expression to,the 


label. Designate as external and put in the label file. An error 
will result if the label is omitted. 


label .DI label exp. 
Assign the address calculated from the label expression to the 


label. Designate as internal and put in the label file. An error 
will result if the label is omitted. 
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eDS label exp. 


Define a block of storage. For example, if label exp. equated 
to 4, then ASSM will skip over 4 bytes. Note: The initial contents 
of the block of storage is undefined. 


eEC 


Suppress output of macro generated object code on source 
listing. This is the default state. See Part 4E. 


EJ 
Eject to top of next page if )HA SET was previously entered. 
EN 
Indicates the end of the source program. 
ES 
Output macro generated object code on source listing. See Part 
4E. 
-FI file 


Assemble the specified file before continuing with statement 
following .FI. 


Note: The .FI pseudo op is allowed only in the control 
file (that designated with .CT). 


-IN label 


Outputs ? followed with space and then accept up to 4 hex 
digits. These hex digits will be assigned to label and stored in the 
label file. 


Input will only occur on the first pass of assembly. The label 
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must be symbolic and should be defined similar to the following 
example: 


BEGIN. ADDR 
-PR “ENTER ASSEMBLY START” 
-IN BEGIN.ADDR 


One should avoid using .DE, .DI, or SET to define the label as 
these constructs reassign their specified value on each pass. 


If the label specified in the .IN pseudo op has not been defined 
when the .IN is encountered, Mae will not accept input. for example, 


-IN VALUE 


VALUE 


In this case, MAE will not accept input. To correct this, 
simply move the label to or in front of the .IN pseudo op. 


LC 


Clear the list option so that the assembly terminates printing 
the source listing after the .LC on pass 2. 


-LS 


Set the list option so that the assenbly begins printing out the 
source listing after the .LS on pass 2. 


A 


eMC label exp. 
When storing object code, move code to the address calculated 
from the label expression but assemble in relation to that specified 


by the .BA pseudo op. An undefined address results in an immediate 
assembly halt. 


«MD 


_Nacro definition. See Part 4E. 
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ME 


Macro end of definition. See Part 4E. 


MG 


MG declares the entire contents of the text file as Macro 
Global. When assembling from disk, all following files will be 
loaded into the text file area following the file with the .MG. 
Thus, even though there can be many modules loaded and assembled, the 
macro global file is “locked” into the text file area providing its 
macro definitions for use by all subsequent files. 


OC 


Clear the object store option so that object code after .0C is 
not stored in memory. This is the default option. 


-OS 


Set the object store option so that object code after the .0S is 
stored in memory on pass 2. 3 


ePR “text” 


Output the text that is enclosed in quotes when the .PR is 
encountered. MAE automatically issues a carriage return immediately 
before outputting the text. The text will be output only during the 
' first pass of the assembly. 


eRC 


Provide directive to the relocating loader to stop resolving 
address information in the object code per relocation requirements 
and store code at the pre-relocated address. This condition remains 
in effect until a .RS pseudo op is encountered. 
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eRS 


Provide directive to the relocating loader to resolve address 


information in the object code per relocation, and store the code at 
the proper relocated address. This is the default condition. 


-SE label exp. 


Store the address calculated from the label expression in the 
next two memory locations. Consider this address as being an 
external address. Note: If a label is assigned to the .SE, it will 
be considered as internal. 


eSI label exp. 


Store the address calculated from the label expression in the 
next two memory locations. Consider this address as being an 
internal address. 


TABLE C - Label Expressions 


A label expression must not consist of embedded spaces and is 
constructed from the following: 


Symbolic Labels: 
One to 31 characters consisting of the ascii characters 
as previously defined. The maximum number of characters is 
set by the )FORMAT SET n command where o = the maximum 
number allowed. The default maximum is 10 characters per label. 


Non-Symbolic Labels: 
Decimal, hex, or binary values may be entered. If no 


special symbol preceeds the numerals then the ASSM assumes 
decimal (example: 147). If $ preceeds, then hex is 
assumed (example: $F3). If % preceeds, then binary is 
assumed (example: 211001). Leading zeros need not be 


entered. If the decimal or hex string is greater than 
4 digits, only the rightmost 4 are considered. 


If the binary string is greater than 8, only the 
rightmost 8 are considered. 


Program Counter: | 


To indicate the current location of the program counter, 
use the symbol =. | 
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Arithmetic Operators: 
These are used to separate the above label expression 


elements. Two operators are recognized: 
+ addition 
- subtraction 


Examples of some valid label expressions follow: 


LDA #21101 ;LOAD IMMEDIATE $0D 

STA *TEMP+S$01 ;STORE AT BYTE FOLLOWING TEMP 

LDA $471E36 sLOAD FROM LOCATION $1E36 

JMP LOOP+C-$461 ;JMP TO CALCULATED ADDRESS 

BNE =+8 sBRANCH TO CURRENT PC PLUS 8 BYTES 


One special label expression is A, as in ASL A. The letter A 
followed with a space in the operand field indicates accumulator 
addressing mode. Thus LDA A is an error condition since this 
addressing mode is not valid for the LDA mnemonic. 


ASL A+0 does not result in accumulator addressing but instead 
references a memory location. 


TABLE D - Addressing Mode Formats 


Immediate: 
LDA #21101 ; BINARY 
LDA #$F3 ; HEX 
LDA #MASK ; SYMBOLIC 
LDA #°'A sASCII 


LDA #H,label exp. ;HI PART OF THE ADDRESS OF THE LABEL 
LDA #L,label exp. ;LO PART OF THE ADDRESS OF THE LABEL 


Absolute: 
LDA label exp. 


Zero Page: 
LDA *label exp. ;THE ASTERISK (*) INDICATES ZERO PAGE 


Absolute indexed: 
LDA label exp. ,X 
LDA label exp.,Y 


Zero Page Indexed: 


LDA *label exp.,X 
LDA *label exp.,Y 
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Indexed Indirect: 
LDA (label exp. »X) 


Indirect Indexed: 
LDA (label exp.),Y 


Indirect: : F en aie ie 
IMP (label exp.) ONLY TUMP U2SEs THIs mode 
Accumulator: 
ASL A sLETTER A FOLLOWED WITH A SPACE INDICATES 
sACCUMULATOR ADDRESSING MODE 
Implied: 
TAX sOPERAND FIELD IGNORED 
CLC 
Relative: 


BEQ label exp. 


B. Label File (or Symbol Table) 


A label file is constructed by the assembler and may be 
outputted at the end of assembly (if a .LC pseudo op was not 
encountered) or via the )LA command. The output consists of the 
symbolic label and its hex address. Via the )LA command, the user 
may select which type of labels to be output. )LA FIXED outputs all 
program and internal labels, and )LA ALL outputs all labels. When a 
relocatable object file is generated (via )OU command), any 


instruction which referenced an internal label or a label expression 
which consisted of at least one internal label will be tagged with 
special information within the relocatable object file. The 
relocating loader uses this information to determine if an address 
needs to be resolved when the program is moved to another part of 
memory e 


Conversely, instructions which referenced an external label or a 
label expression consisting of all external references will not be 
altered by the relocating loader. 


At the end of the label file the number of errors which occurred 
and program break in the assembly will be outputted in the following 
format: //xxxx,yyyy,zzzz 


Where xxxx is the number of errors found tin deciaal 
representation, yyyy is last address in relation to .BA, and zzzz is 
last address in relation to .MC. 
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C. Assembling 


Source for a large program may be divided into modules, entered 
{nto the text file one at a time and recorded on disk using )PU. 


These modules can be linked together during assembly via a 
control file. If used, the control file must be the first file to be 
assembled. This file must be in the text buffer when the )AS command 
is issued, or its name must be specified in the )AS command (example: 
)AS "MEM.TEST”). Files are linked together via the -.FI pseudo op. 
For example, to assemble 3 files named X-MO1, Y.MO2, and Z.M03, we 
need to generate a control file say M.CTL (note for convenience we 
use the convention of tagging CTL on the end of any name which 
references a control file while its modules are tagged Mxx). The 
file M.CTL may contain the following: 


CT 
-FI D16 “X.MO1" 
-FI D16 “Y.MO02” 
«FI D16 “Z.M03" 
eEN 


Now, when the control file is assembled, MAE is told to go 
assemble the files in the order specified. 


At assembly, the assembler can load and assemble each module 
until the entire program has been assembled. This will require two 
passes for a complete assembly. When the end of a pass is 
encountered, MAE will output the message END MAE PASS!. If for some 
reason you terminate the assembly on the second pass, you may restart 
at the beginning of the second pass using the )PASS command. 


D. Creating a relocatable object file (via )OU) 


In order to create a relocatable object file, the programmer 
should identify those labels whose addresses are fixed and should not 
be altered by the relocating loader. This is done via the .DE pseudo 
op. Non-symbolic labels (example: $0169) are also considered as 
being external (or fixed). All other labels (including those defined 
via the .DI pseudo op) are considered as internal. Addresses 
associated with internal labels can be altered by an offset when the 
program is loaded via the relocating loader. 


Also, the .SE stores a two byte external address and the .SI 


stores a two byte internal address. Similarily the relocating loader 
will alter the internal address and not the external address. 
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An example of an external address would be the calls to Apple 
monitor routines (eg JSR $FDED) or any location whose address remains 
the same no matter where the program is located. Other external 
addresses would be locations in zero page that the Apple monitor or 
DOS uses. An example using an internal address would be when you 
-want to store the address of a number of subroutines in a table. An 
example illustrating how MAE stores command mnemonics and associated 
processing routine is as follows: 


«BY ‘CO’ ;COPY COMMAND 
-SI COPY.MOD ;COPY MODULE 
~BY ‘'MO' ;MOVE COMMAND 
eSI MOVE.MOD ;MOVE MODULE 
BY ‘PR' > PRINT COMMAND 


eSI PRINT.MOD #£=;PRINT MODULE 


Expressions consisting of internal and external labels will be 
combined and considered an internal address. For example, suppose 
the label BUFFER was contained in your program as BUFFER .DS 80. 
Then references consisting of the label BUFFER and the _ external 
reference +3, such as LDA BUFFER+3, would be combined and considered 
as an internal reference. Thus the relocating loader will alter 
references to BUFFER+3 when you relocate the program. A label 
expression consisting entirely of external labels will be combined 
and considered as external. 


The relocating loader can relocate your program in 3 segments: 
Zero page variables (internal addresses in range S00-SFF), absolute 
variables (internal addresses in range $0400-S1FFF), and program body 
ney pi in range $2000-SFFFF). To generate a relocatable object 

fle, first partition your program into internal and external 
references. Remember, external references are those locations that 
are fixed while internal references are those locations which can be 
altered by the relocating loader. 


Start assigning cero page references at location $0000, absolute 
veritable locationa at 99400, and begin annembly of the progras at 
12441. (The progres will not be relocated properly unless it is 
| 2000.) Next assemble the progras via )AS, and 


to generate a relocatable object file. 


Now, we have the relocatable object code on disk. To load this 
object code back into memory, first load the relocating loader. The 
relocating loader is contained on the diskette with the nee 
RELOC.EXE. Execution begins et $800 if ia the sonitor or CALL 2048 
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if in Basic. The relocating loader will request the following: 


1) FILENAME? Name of the file containing the relocatable object 
code. (Enter with quotes around name.) 


2) Z-PG OFFSET? Address to begin assignment of zero page internal 
references. 


3) ABS OFFSET? Address to begin assignment of absolute internal 
references. 


4) PGM EXE OFFSET? Address the program is to execute. 


5) PGM STORE OFFSET? Address to store the program object code. 


When the file has been relocated in memory, it can be saved on 
disk (via BSAVE) as an executable file, which may be reloaded without 
using the relocating loader. 


As an exanple, lets assume we want to relocate a program named 
UART to execute at location $3000, but store the object code at 
$1000, and start the zero page variables at $0060, and the absolute 
variables at $4000. We would respond to the relocating loader as 
follows: 


FILENAME? D16 “UART.REL” _ File name 
Z~-PG OFFSET? 60 _ Assign start of zero page var. 
ABS OFFSET? 4000 _ Assign start of absolute var. 
PGM EXE OFFSET? 3000 _. Program body start 
PGM STORE OFFSET? #1000 _. Store of code start 
LOAD MAP 
2 _ RL. outputs @ lost aap 
: 
VP ILENAME? _ Eater juet carriage returo to exit the 


Relocating Loader 
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E. Macroe 


: MAE provides amacro capability. A macro is essentially a 
facility in which one line of source code can represent a function 

consisting of many instruction sequences. For example, the 6502 

instruction set does not have an instruction to increment a double 

byte memory location. A macro could be written to perform this 

operation and represented as INCD (VALUE.1). This macro would appear 

in your assembly language listing in the mnemonic field similar to 
the following: 


BNE SKIP 
NOP 


INCD (VALUE.1) ; INCREMENT DOUBLE 
LDA TEMP 


Before a macro can be used, it must be defined in order for ASSM 
to process it. A macro is defined via the .MD (macro definition) 
pseudo op. Its form is : 


11 !label .MD (Ll L2 ..- Ln) 


Where label is the name of the macro (!!! must preceed the 


label), and Ll, L2, ...-, Ln are dummy variables used for replacement 
with the expansion variables. These variables should be separated 


using spaces, do not use commas. 


To terminate the definition of a macro, use the .ME (macro end 
pseudo op). ? 


For example, the definition of the INCD (increment double byte) 
macro could be as follows: 


!1{!INCD .MD (LOC) ; INCREMENT DOUBLE 


INC LOC * 

BNE SKIP 

INC LOC+1 
SKIP »ME 


This is a possible definition for INCD. The assembler will not 
produce object code until there is a call for expansion. 


Note: A call for expansion occurs when you enter the macro 
name along with its parameters in the mnemonic field as 
INCD (TEMP) or INCD (COUNT) or INCD (COUNT+2) 
or any other labels or expressions you may choose. 


Note: In the expansion of INCD, code is not being generated 
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which increments the variable LOC but instead increments the 
associated variable in the call for expansion. 


If you tried to expand INCD as described above more than once, 
you will get a !06 error message. This is a duplicate label error 
and it would result because of the label SKIP occurring in the first 
expansion and again in the second expansion. 


There is a way to get arround this and it has to do with making 
the label SKIP appear unique with each expansion. This is 
accomplished by rewriting the INCD macro as follows: 


111INCD .MD (LOC) s INCREMENT DOUBLE 
INC LOC 
BNE ...SKIP 
INC LOC#1 

o+sSKIP ME 


The only difference is ...SKIP is substituted for SKIP. What 
the ASSM does is to assign each macro expansion a unique macro 
sequence number (2**16 maximum macros in each file). If the label 
begins with ... then ASSM will assign the macro sequence number to 
the label. Thus, since each expansion of this macro gets a unique 
sequence number, the labels will be unique and the !06 error will not 
occur. 


If the label ...SKIP also occurred in another macro definition, 
no !06 error will occur in its expansion if they are not nested. If 
you nest macros (i.e. one macro expands another), you may get a !06 
error if each definition uses the ...-SKIP label. The reason this may 
occur is that as one macro expands another in a nest, they each get 
sequentially assigned macro sequence numbers. As the macros work out 
of the nest, the macro sequence numbers are decremented until the top 
of the nest. Then as further macros are expanded, the sequence 
numbers are again incremented. The end result is that it is possible 
for a nested macro to have the same sequence number as one not nested 
or one at a different level in another nest. Therefore, if you nest 
macros, it is suggested that you use different labels in each macro 
definition. 


Some further notes on macros are: 
1) The macro definition must occur before the expansion. 


2) The macro definition must occur in each file that 
references it. Each file is assigned a unique file 
sequence number (2**16 maximum files in each assembly) 
which is assigned to each macro name. Thus the same 
macro can appear in more than one file without 
causing a 106 error. If a macro with the same name 
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is defined twice in the same file, then the !06 error 
will occur. : 


3) Macros may be nested up to 32 levels. This is a 
limitation because there is only so much memory left 
for use in the stack. 


4) If a macro has more than one parameter, the parameters 
should be separated using spaces - do not use commas. 


5) The number of dummy parameters in the macro definition 
must match exactly the number of parameters in the call 
for expansion. 


6) The dummy parameters in the macro definition must be 
symbolic labels. The parameters in the expansion may 
be symbolic or non-symbolic label expressions. 


7) If the .ES pseudo op is entered, object code generated 
by the macro expansion will be output in the source 
listing. Also, comment lines within the macro 
definition will be output as blank lines during 


expansion. Conversely, if .EC was entered, only the 
line which contained the macro call will be output 


in the source listing. 


8) A macro name may not be the same as a 6502 mnemonic, 
pseudo op, or conditional assembly operator. 


F. Conditional Assembly 


MAE also provides a conditional assembly facility to 
conditionally direct the assembler to assemble certain portions of 
your program and riot other portions. For example, assume you have 
written a CRT controller program which can provide either a 40, 64, 
or 80 character per line display. Instead of having to keep 3 
different copies of the program, you could use the ASSM conditional 
assembly feature to assemble code concerned with one of the character 
densities. 


Before we continue with this example, lets describe the 
Conditional Assembly operators: 


IFE label exp. 


If the label expression equates to a zero quantity, then 
assemble to end of control block. 
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IFN label expe 


_I£ the label expression equates to a quantity not equal 
to zero, then assemble to end of control block. 


IFP label exp. 


If the label expression equates to a positive quantity 
or 0000, then assemble to end of control block. 


IFM label exp. 


If the label expression equates to a negative (minus) 
quantity, then assembly to end of control block. 


hk 


Three asterisks in the mnemonic field indicates the end 


of the control block. 
SET label=label exp. 


Set the previously defined label to the saan de 
calculated from the label expression. 


NOTE: All label expressions are equated using 16 — bit 
precision arithmetic. 


Going back to the CRT controller software example, a possible 
' arrangement of the program is as follows: 


CHAR .LINE -DE 40 


IFE CHAR.LINE-40 


sCODE FOLLOWS FOR 40 CHARACTER PER LINE 


° 
RRR 
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IFE CHAR.LINE-64 
3;CODE FOLLOWS FOR 64 CHARACTER PER LINE 


e 
e 
RRR 


IFE CHAR.LINE-80 
;CODE FOLLOWS FOR 80 CHARACTER PER LINE 


e 
e 
RRR 


;COMMON CODE FOR ALL 


Shown is the arrangement which would assemble code associated 
with 40 characters per line since CHAR.LINE is defined as equal 40. 
If you wanted to assemble for 80 characters, simply define CHAR.LINE 
as equal 80. 


Conditional assembly can also be incorporated within macro 
definitions. A very powerful use of conditional assembly, is the 
ability to cause a macro to be fully expanded on the first reference 
and only partly expanded on subsequent references. For example, 
assume you wrote a macro todo a sort on some data. It could be 


defined as follows: 


EXPAND .DE 0 
{!!SORT .MD 
IFN EXPAND 


JSR SORT.CALL § ;CALL SORT 
Rkk 


IFE EXFAND 
JSR SORT.CALL 
JMP ..-ABC 


sSORT CODE FOLLOWS 
SORT. CALL 


RTS 


ee ABC SET EXPAND=1 
RAR 
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In this example, EXPAND is initially set to 0. When the macro 
is expanded for the first time, EXPAND equals 0 and the code at 
SORT.CALL will be assembled along with a JSR to and a JMP around the 
sort subroutine. Also, the first expansion sets EXPAND to 1. On 
each suceeding expansion, only a JSR instruction will be assembled 
since EXPAND equals 1. Using conditional assembly in this example 
resulted in more efficient memory utilization over an equivalent 
macro expansion without conditional assembly. 


G. Interactive Assembly 


Interactive assembly is a new concept in which the assembler can 
be instructed to print messages and/or accept keyboard input during 
the first pass of the assembly. 


Interactive assembly makes use of two pseudo ops: 


-PR to print messages 
eIN to accept keyboard input 


An example of the use of interactive assembly is as follows: 


ePR “INPUT START OF ASSEMBLY” 
ADDR 

eIN ADDR 

-BA ADDR 


Note that in this example, the assembler will request entry of 
an address to be assigned to ADDR, and then begins assembly at that 
address. Interactive assembly could be used in our CRT controller 
example as follows: 


7 ePR “INPUT WHICH CONTROLLER (40, 64, 80)” 
CHAR.LINE -IN CHAR.LINE 


NOTE: In the above example, the label CHAR.LINE was defined 
on the same line as the .IN This is perfectly OK and 
it eliminates the need to define CHAR.LINE on a 
separate line using the .DE pseudo op. You might say 
that it kills two birds with one stone. 


There are many applications for interactive assembly but those 
possibilities are left for the users of MAE. 
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NOTE: Never specify a label as the operand in the .IN 
pseudo op that has been defined by the .DE, .DI, 
or SET pseudo ops. The reason is that these 
pseudo ops initialize the address assigned to 
associated labels on both assembly passes while 
all other labels are initialized only on the first 
pass. Since the .IN pseudo op accepts input on 
the first pass only, usage of labels defined by 
DE, -DI, and SET will cause different label . 
values on pass 1 versus pass 2. 


H. Default Parameters on entry to ASSM 


—- Does not store object code in memory (otherwise use .0S) 

-—- Begins assembly at $0800 (otherwise use .BA) 

~- Halts assembly on errors (otherwise use .CE) 

— Stores object code beginning at $0800 unless a .BA or .MC 
is encountered and if .OS is present. 

-- Object code generated by macros does not appear on the 
assembly listing (1.e. default is .EC) 


5- RELOCATING THE RELOCATING LOADER 


| A relocatable object file of the relocating loader is contained 
on the diskette with the name RELOC.REL. 


To relocate the relocating loader, load the executable copy 
(RELOC.EXE) and begin execution. When FILE NAME? is output, enter 
“RELOC.REL”. Then enter 0 for Z2-PG OFFSET? and 0 for ABS OFFSET?. 
Finally, enter the address of the location you want the relocating 
loader to execute and reside for PGM EXE OFFSET?, and PGM STORE 
OFFSET?. 


When the relocator completes its task, you may save an 
executable copy on disk using the Apple monitor. Just remenber, 
execution begins at the address specified for the PGM EXE OFFSET - 
not $0800 as for the executable copy supplied (RELOC.EXE). 


6. ERROR CODES 


An error message of the form !xx AT LINE yyyy where xx is the 
error code and yyyy is the line number will be outputted if an error 
occurs. Sometimes an error message will output an invalid line 
number. This occurs when the error is on a non-existant line such as 
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an illegal command input. 


The following is a list of error codes not specifically related 
to macros: 


ERROR CODE - DESCRIPTION 
1B e-EN in non .CT file when .CT file exists. 
1A EN missing in .CT designated file. 
19 Found .FI in non .CT file. 
18 
17 Checksum error on disk load. 
16 
15 Syntax error in )ED command. 
14 
13 Multiple .CT assignment. 
12 Command syntax error or out of range error. 
ll Missing parameter in )NU command. 
10 Overflow in line # renumbering. 


CAUTION: You should properly renumber the 
the text file for proper command operation. 


OF Overflow in text file - line not inserted. 
OE Overflow in label file - label not inserted. 
OD. MAE expected hex characters, found none. 
Oc Illegal character in label. 

OB Unimplemented addressing mode. 

OA Error in or no operand. 

09 Found illegal character in decimal string. 
08 Undefined label (may be illegal label). 

07 -EN pseudo op missing. 

06 Duplicate label. 

05 Label missing in .DE or .DI pseudo op. 

04 -BA or .MC operand undefined. 

03 Illegal pseudo op. 

02 Illegal mnemonic or undefined macro. 

Ol Branch out of range. 

00 Not a zero page address. 

ED Error in command input. 


The following is a list of error codes that are specifically 
related to macros and conditional assembly: 


ERROR CODE ie—it*éws _._-: DESCRIPTION 
2F Overflow in file sequence count (2**16 max.) 
2E Overflow in number of macros (2**16 max.) 
2D 
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2c 3 
2B -ME without associated .MD 
2A Non-symbolic label in SET pseudo op. 
29 Illegal nested definition. 
28 
27 : Macro definition overlaps file boundary. 
26 | Duplicate macro definition. 
25 Quantity parms mismatch or illegal characters. 
24 Too many nested macros (32 max.) 
23 Macro definition not complete at .EN 
22 Conditional suppress set at .EN 
21 Macro in expand state at .EN 
20 Attempted expansion before definition. 


7. STRING SEARCH AND REPLACE COMMANDS 
A. Edit Command 

A powerful string search and replace, and line edit capability 
is provided via the )EDIT command to easily make changes in the text 
file. Use form 1 to string search and replace, and form 2 to edit a 
particular line. 


Fors 1 


JEDIT tSleS2t %d * x y 


Where: t is a non-numeric, non-space terminator 

S1 is the string to search for 

S2 is the string to replace Sl 

d is don't care character. Preceed with % 
character to change the don't care, else 
don't care character will be % by default. 

ad indicates to interact with user via 
subcommands before replacing Sl 

# indicates to alter but provide no printout 
Note: No * or # indicates to alter and 

provide printout. 
x line number start in text file 
y line number end in text file 


Asterisk (*) prompter subcommands: 


A alter field accordingly 

D delete entire line 

M move to next field -— don't alter current 
$ skip line - don't alter 

» 4 exit )ED command 

2 enter form 2 
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Defaults: d= @ 
x « Q 
y = 9999 


If no * or # entered then print all 
lines altered. 


For example, to replace all occurances of the label LOOP with 
the label START between lines 100 and 600, enter: 


JEDIT /LOOP/START/ 100 600 


If you want to delete a reference to LOOP, enter a null string 
replacement as follows: 


JED /LOOP// 


If you want to delete all references to LOOPO], LOOPO2, etc, 
enter: 


JED /LOOPZ%// 
To simply delete all occurances of LOOP, enter: 


YEDIT /LOOP// 100 600 


To do the same thing as above but not display changes on the 
screen, enter: 


YED /LOOP// # 100 600 


The slash ("/") was used in the above examples as the terminator 
but any non-numeric character may be used. 


Suppose, for example, there are some occurrances of the label 
BUFFER that you wish to change to CRT/BUFFER, some you wish to delete 
(the entire line), and some that you wish to extensively edit. This 
requires a conditional replacement capability with you as a decision 
maker. To do this, enter: 


JED &BUFFERS&CRT/BUFFER& * 
(Note that the string terminator & is used because / is actually 
a part of the string.) 


Now, each time MAE‘s edit command encounters the string BUFFER, 
the line will be printed on the screen and an astrisk (*) prompter 
will appear awaiting your entry of one of the subcommands (A, D, M, 
S, X, 2) described above. For example, to replace BUFFER with 
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CRT/BUFFER, press “A”. To delete the entire line, press "D", to 
exensively edit the line, press "2", etc. When you have made your 
decision for the current line, the next occurance of BUFFER will be 


displayed. This continues until the end of the text file or until 
you enter the “X” subcommand. 


At the end of the )EDIT operation, the number of occurances of 
the string will be output as //xxxx where xxxx is a decimal quantity. 


Form 2 


JEDIT no 


Where: n is the line number (0-9999) of the line to 
be edited. 


7 After executing this command, the cursor will be positioned at 
the beginning of the line. The usual Apple screen editing escape 
characters may be used to change the line of text. When the return 


key is pressed, MAE will insert the corrected text into the text 
file. 


B. Find Command 


If you want to just find certain occurances of a particular 
string, use the )FIND command. Its form is: 


)FIND -tSlt # x y 
Where: t¢t, Sl, #, x, and y are as defined in EDIT command. 


For example, )FIND /LDA/ will output all occurances of the 
string LDA in the text file. 


At the end of the )FIND operation, the number of occurances of 
the string will be output as //xxxx where xxxx is a decimal quantity. 


A untque use of this command is to count the number of 


characters in the text file (excluding line numbers). The form for 
this is: )FIND /2/# 


8. CONTROL CODES (Serial Device) 
Ascii characters whose hex values are between hex 00 and 20 are 


normally non-printing characters. With a few exceptions, these 
characters will be output in the following manner: c where c is the 
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associated printable character if hex 40 was added to its value. For 
example, ascii 03 will be output as C, and 18 as X, etc. 


In addition, some of these control codes have special functions 
in MAE. 


Control codes which have special functions are: 


CODE DESCRIPTION 
@ Null (hex 00) 
B Restore zero page and go to Basic 
C Restore zero page and go to Monitor 
G * Bell 
H * Backspace (delete previously entered char.) 
i Horizontal tab to next 8-th char. position 
PO Line feed 
M *® Carriage return 
0 Continue processing but no output 
Q * Continue after stop via break key 
xX Delete entire line altered 
Y Restore zero page and jump to location $0000. 
(you may reenter at $5003) 
Z Terminate processing and go to “)” level 
t..* Escape character 


* = Non-printing control character. 


9. USING MAE's BUILT IN SOFTWARE UART 


NOTE : This is an optional feature of MAE and need not be 
incorporated. | 


If you want to connect an 80 column device (such as an external 
CRT terminal or TTY) to your Apple because the 40 column screen seens 
“cluttered”, you can use MAE's built-in software UART driver. This 
software UART is also useful if you want to “remote” the Apple and 
access via a termtnal and modem. All that is required is a parallel 
port card - you don't have to purchase a special serial I/0 card for 
this application. 


Practically any serial device may be connected and controlled by 
this software. This software UART converts bytes to serial format 
and inputs and/or outputs using just 2 bits of a parallel port. The 
data format consists of one start, 8 data, and 2 stop bits. Via 
appropriate commands, the user can specify the baud rate and also the 
number of pad bits on carriage return. 
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We have found that many RS232 devices can be connected directly 
to a TTL level parallel port without level conditioning circuitry. 
But if you provide RS232 or other conditioning circuitry, you should 
not invert the signals as they are in their positive true state. 


The commands )TI and )TO are provided to direct MAE to input or 


output thru this software UART, and to specify baud rate and pad 
Example: )TO SERIAL nao __ direct output thru UART transmitter 
)TI SERIAL oo _ input from UART receiver 
)TI TERMINAL nm — direct all input and output thru 
software UART 
Note: )TI SERIAL and )TI TERMINAL will “lock out” the Apple 


keyboard. To revert back to the Apple keyboard, type 
)TI APPLE on the external terminal keyboard. 


The software UART is shipped unconfigured. To activate this 


software you must configure it for your system by supplying 
appropriate addresses and bit positions as follows: 


Address Object Source 


sIF PIA THEN INITIALIZE DIRECTION REGISTER 
sELSE JUST NOP THIS PART 


7276 - AD xx xx LDA PORT.DIR 3;GET FROM DIRECTION REGISTER 
7279 - 29 xx AND #xx s INITIALIZE BIT FOR INPUT 
727B - 09 xx ORA fyy sINITIALIZE BIT FOR OUTPUT 
727D - 8D xx xx STA PORT.DIR sSTORE IN DIRECTION REGISTER 
sGET SERIAL INPUT FROM PARALLEL PORT 
s (SAME CODE BUT THREE DIFFERENT LOCATIONS) 
7285 - AD xx xx LDA PORT.DATA ;GET FROM PORT 
7288 ~ 2 xx AND #zz sMASK OUT ALL EXCEPT INPUT BIT 
728E - AD xx xx LDA PORT.DATA ;GET FROM PORT 
7291 - 29 xx AND #zz sMASK OUT ALL EXCEPT INPUT BIT 
72B9 - AD xx xx LDA PORT.DATA ;GET FROM PORT 
72BC —- 29 xx AND #zz sMASK OUT ALL EXCEPT INPUT BIT 
3PUT SERIAL OUTPUT TO PARALLEL PORT 
7344 - AD xx xx LDA PORT.DATA ;GET FROM PORT 
7347 - 29 xx AND fww : sDEFAULT TO OUTPUT ZERO BIT 
7349 - 90 02 BCC SKP ;BRANCH IF TO OUTPUT ZERO BIT 
734B - 09 xx ORA #vv sELSE OUTPUT A ONE BIT 
734D - 8D xx xx SKP STA PORT.DATA ;PUT TO PORT 
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10. EXAMPLES 
A. TED Examples 


#1 Illustrate to ways to load MAE and begin execution at 
the cold start. 
BLOAD MAE.EXE or BRUN MAE .EXE 
CALL 20480 


#2 Illustrate entry of text. 
YAUTO 10 
)1000;THIS IS A TEST 
LOLOLOOP LDA VALUE, Y 
1020 NOP 
1030END.PGM .EN 
1040// _Note, enter // to exit 
auto line f-ing 


#3 Illustrate listing of text. 


)PRINT 
1000 ;THIS IS A TEST 
1010 LOOP LDA VALUE, Y 
1020 NOP 
1030 END.PGM EN 
// 


#4 Put file to disk (drive 2,slot 6) with name TEST. 
)PUT D26 “TEST” 


#5 Get file from disk (drive 1 slot 6) named TEST. 
)GET “TEST” 


Note: The default is drive 1 slot 6. 


#6 Assemble file CRIDVR and generate a listing. 
JASSM “CRTDVR™ LIST 


#7 Output directory for default drive and for drive 2, slot 6. 
pC “CATALOG” _ default drive 
)DC “CATALOG,D2,S6" — drive 2, slot 6 


#8 Delete binary file TEST.EXE. 
)DC “DELETE TEST.EXE”™ 


#9 Delete source file TEST.ASM. 
)DC “@TEST.ASM” — actually deletes TEST.ASM and 
TEST.ASM* 
#10 Clear the text file. 
)CLEAR 
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#13 


#14 
#15 
#16 


#17 


#18 


#19 
#20 
#21 


#22 


wr ~ 


PAGE 38 


Direct output to printer. 


)TO PRINTER _. with non-standard interface or standard 
interface using PARL.OUT driver (included) 


)DC “PR#n” __ with standard interface at slot a 
not using PARL.OUT 


Direct output thru UART at 300 baud with 
10 pad bits. 
)TO SERIAL 1 10 


Assign device associated with UART as input (keyboard) and 
output (with 2 pad bits). 
)JTI TERMINAL 2 


S __ user types S on serial keyboard then 
types RETURN. 


Find all occurrances of the text LDA. 
)FIND /LDA/ : 


Replace all occurances of LDA FA with LDA *FA 
between lines 1000 and 2000. 
JEDIT /LDA FA/LDA *FA/ 1000 2000 


Provide for 15 characters per label. 
)FORMAT SET 15 


Outpuf all fixed (external) labels. 
)LABELS FIXED 


Renumber the text file beginning at line number 100 
and incrementing by 5. 
)NUMBER 100 5 


Move lines 100 thru 200 to after line 9000 
YMOVE 9000 100 200 


Print lines 900 thru 976 
)PRINT 900 976 


Reallocate the text file to $400 thru $1FFC 
)SET $400 $LFFC 


Go to Basic. 
)BASIC or CTRL-B return via CALL 20480 (cold start) 
or CALL 20483 (warm start) 
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#23 Go to Machine Langu age Monitor. 


)BREAK or CTRL-C return via 5000G (cold start) 
or 5003G (warm start) 


#24 Run assembly program at symbolic label BOX. 
)RUN BOX 


#25 Run assembly program at hex address $A03 
YRUN $A03 


B. ASSM Examples 


#1 Begin assembly at $1000 and store object code. 
~-BA $1000 
OS 


#2 Begin assembly at $1000 but store object code at $4000. 
-BA $1000 
-MC $4000 
-OS 


#3 Define the CRT output routine. 
COUT .DE S$FDED 


#4 Assign an internal work location in zero page. 
WORK .DI $0 


#5 Allocate 6 bytes of storage. 
TABLE .DS 6 


#6 Define label EOI as mask with bit 6 set and show use 
in AND statement. 
EOI -DE 201000000 
AND #EOI 


#7 Load the low address part of the label VALUES in register X 
"and high part in register Y. 

LDX #L,VALUES 

LDY #H,VALUES 


#8 Give example of .BY pseudo op. 
eBY ‘ALARM CONDITION ON MOTOR 1° SOD SOA 


#9 Store the address of the internal label TABLE and 


the external label COUT. 
eSI TABLE 
eSE COUT 
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#10 Define the contents of the text file as Macro Global 
so its macro definitions can be used by subsequent 
files in the assenbly. 

MG 


NOTE: This locks the macro definitions in the text 
_ puffer. If you get a !0OF error on subsequent 
loads, you should know that you have overflowed 
the text buffer. The solution is to allocate 
more memory via )SET command and then 
reassemble. 


#11 Show example of a very long label. 
MEMORY. TEST.FOR.6502 
JMP MMMORY.TEST.FOR.6502 


NOTE: Long labels (greater than that specified via 
)FO command) are allowed if defined on a 
line with no mnemonics. 


#12 Reference the call to the BASCALC Apple routine 
so the relocating loader will not alter the address 
during loading. 
BASCALC .DE §$FBCl 


JSR BASCALC 
-— OR — 


JSR SFBC1 


11. GETTING STARTED WITH MAE 
Load MAE as follows: 
1) Insert MAE diskette in appropriate disk drive. 
2) Boot the system from the MAE diskette. 
Do if you have Applesoft ROM Basic: 
3) A menu will be displayed on the screen. 
Select from the menu to execute MAE or the Relocating 


Loader, or to go to Basic or the Monitor. 
To get started, select to execute MAE. 
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Do if you have Integer ROM Basic: 
4) The message FILE TYPE MISMATCH will be displayed 

because the greeting program was in Applesoft Basic. 
(Note: A listing of this menu program is provided 
in Part 16 which you can modify for Integer Basic 
if necessary.) 

Simply BRUN the desired program. 

To get started, type BRUN MAE.EXE 


MAE will respond with: 


C 1979 BY C MOSER 


3000-4FFC 1800-2FFC 7800 
3000 1800 


) 


This displays the default allocations of memory for the text 
file (3000-4FFC), label file (1800-2FFC), and start address of the 
256 byte relocatable buffer (7800). On the next line, the current 
end of the text file and label file are displayed. Since they are 
initially cleared, these are the same as their respective start 
addresses. You should note that the current end will change as you 
insert/delete data in the text file and label file. The )SET command 
can be used to display this range again or alter the file boundaries. 


Remember, to exit MAE, issue either the )BASIC or )BREAK 
commands to go to Basic or to Monitor. You may reenter MAE via 5003G 
(warm start - everything preserved) or 5000G (cold start - everything 
cleared to default state). If you are in BASIC, type CALL 20483 to 
warm start MAE. This is the same as 5003G from the monitor. 


The first thing you should do now is to load the MAE.NOT file 
via 


)GET “MAE.NOT™ 
)FORMAT CLEAR __ turn formatting off 


The MAE.NOT file will contain any pertinent information 
pertaining to MAE that was discovered after this manual was printed. 
Please review the information in this file. 


Now you should start playing around with MAE by executing its 
commands and then proceeding to entering programs. Try reviewing the 
commands in Part 3, assembler features in Part 4, and then the 


examples in Part 10. 
We hope you find MAE to be an excellent program development aid 
worthwhile investment. Happy Asseabling!!! 


APPLE MAE ~ COPYRIGHT 1980 BY EASTERN HOUSE 


PAGE 42 


12. THE MAE SIMPLIFIED TEXT PROCESSOR (STP) 


The MAE Simplified Text Processor (STP) is a word. processor 
program designed specifically to work with the MAE text editor. The 
STP coexists with the MAE and occupies memory between $A00 and $152F. 
The primary purpose of this word processor was to provide a 
simplified means to process program documentation and for other text 
processing needs. (This manual was produced using the STP.) This 


simplicity was accomplished with a set of easily remembered word 
processing functions, and usage of an already familiar text editor to . 
enter and edit the raw text. 


STP, unlike some word processing programs, can output the 
formatted text to the _ screen. This. is most useful on 80 column 
displays and can result in a tremendous savings in time and paper. 


The STP word processor also provides lower case printing 
capability (for printer only) for Apple IL systems without lower case 
hardware modifications. This, of course, assumes that the printer ts 
capable of printing lower case characters. The STP automatically 
converts all alphabetic characters to lower case for the printer and 
then back to upper case for the CRT. Two special command characters 
are used to provide upper case: "]" and "<". These characters are 
inserted in the raw text file but are not printed by either the 
printer or the CRT when the file is formatted. In order to provide a 
single upper *°case character at the beginning of a sentence or the 
first letter of a proper name, use the "<" immediately before typing 
the character to be capitialized. The "]” character is used like a 
shift-lock key. When the STP first reconizes this special character, 
the lower case conversion is deactivated until another ”]” character 
is encountered. The printer driver included in the MAE (the 
nonstandard serial driver or the PARL.OUT driver included on the MAE 
disk) is required in order to utilize the < and j] characters to 
obtain lower case characters on the printer. 


If your system has lower case modifications installed, the STP 
can be configured to handle lower case to the Apple screen by 
inserting three NOP's at $OB3D-SOB3F and at $1485-$1487. 


To instruct the word processor to perform a word processing 
function, one inserts text macros in the text to be formatted. A 
text macro always begins with a period (.), always begins in coluan 
1, may be entered as upper or lower case, and may or may not have 
associated parameters. The following are the macros provided by the 
STP word processor: 
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VERTICAL SPACING (.vspace n) 


This macro is used to provide single, double, triple spacing, 
etc. for the entire output. Enter the macro as shown above with the 
desired spacing. For example, to request a double spaced output, 
enter .vspace 2. 


TEMPORARY INDENT (.8n) 


To indent n spaces on the next line, use the .sn macro where n = 
the number of spaces to indent. For example, .s5 will indent the 
next line 5 spaces from the left. 


MARGIN CONTROL (.m n pq r) 


The margins default to 66 lines per page, left margin begins at 
column 0, print width = 76 characters per line, and the number of 
blank lines between text body and each title and footer = 3. 


The parameters in the margin macro are: 

n = left margin begin position (default = 0) 

p = number of characters per line (default = 76) 

q = number of lines per page minus r. Example if lines per 
page = 66 and the number of blank lines between 
titles and footers = 3, then q = 66-3 = 63. 

r= number of blank lines between text body and each header 
and footer. Default = 3. 


For example to specify left margin to begin in column 5, print 
width of 60, 66 lines/page, and 4 spaces between text body and titles 
and footers, enter .m 5 60 62 4. 


If you enter just .m 5 60, the previously entered values for 
parameters q and r will be assumed. The margin may be changed at any 
point as desired in the text. The maximum value for n is 76. 


TURN OFF JUSTIFICATION (.nofil1l) 


The .nofill macro turns off the justification function. This 
means that the lines will be printed without adding spaces to make 
the margins come out even. Also, lines of text are not combined to 
fill to the specified margins. 
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BEGIN A NEW PAGE (.ff) 


The .ff€ macro may be entered when one wants the printer to eject 
to the top of the next page. 


CONDITIONAL FORM FEED (.ff n) 


Perform a form feed if less than n lines remain at the bottom of 
the page. 


LITERAL SPACE (Acharacter) 


Normally, spaces are not processed like other characters. If 
several spaces are entered consecutively, the STP word processor 
reconizes only one space and deletes the rest. If it is desired to 
force a certain number of spaces in a line for tabular formats, etc., 
a string of caret (A) characters may be inserted into the text but 
one must be in the shift-lock mode. The caret will not be printed 
when the text is processed but instead a space will be printed for 
each occurance of the caret. : 


TURN ON JUSTIFICATION (. ju) 
The .ju macro may be entered in order to restore justification. 


«ju is normally used to revert back to justification after using the 
enofill macro. 


RAGGED RIGHT MARGIN (.rr) 
This macro turns off the addition of spaces in order to make the 
margins come out even. Lines of text are still combined in order to 


approximate the specified number of characters per line. The left 
margin will be straight but the right margin will be ragged. 


RAGGED LEFT MARGIN (.rl) 


This macro is the sase as the .rr macro except that the right 


APPLE MAE - COPYRIGHT 1980 BY EASTERN HOUSE 


PAGE 45 


margin is straight and the left margin is ragged. 


SKIP NEXT N LINES (.1n) 

Use this macro to skip a number of lines before printing the 
next line of text. For example, to skip 2 lines and begin printing, 
enter .12. If you enter .1 by itself, one will be assumed. Thus .1l 
and .11 are equivalent and each will result in a movement to the next 
line. 


CENTER LINE OF TEXT (.c text) 


This macro is useful for centering a line of text. For example, 
to center the phrase STP Word Processor, enter .c STP Word Processor. 


SWAP JUSTIFICATION MODES (.swap) 


This macro is used to switch from .rr mode to .rl and vice 
versa. 


PARAGRAPH SPECIFICATION (.p d r) and PARAGRAPH IDENTIFICATION (.p) 

Use the -.p d er macro to inform the word processor what a 
paragraph is supposed to be: d = number of lines down, and r = number 
of spaces right for paragraph indent. The default is d = 1, and r= 
5. 


In order to identify a paragraph start in your text, use the .p 
macro with no parameters. 


PARAGRAPH NUMBERING OR IDENTIFICATION (.pi text) 


The best use for this macro is for paragraph numbering. An 
example for this is “.pi 1.01”. 


PAGE TITLE (.t# title text) 
A one line title at the top of each page may be entered using 


this macro. For example, to specify the title CONFIDENTIAL, enter .t 
CONFIDENTIAL. If you want to also include a page number, enter .t# 
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CONFIDENTIAL. Note that the # specifies page numbering. If you want 
just a page number (the default state), enter just .t#. If you want 
neither title nor page number, enter just .t to turn off all titlirg. 


PAGE FOOTERS (.foot# foot text) 


A one line footer at the bottom of each page may be specified 
using this macro- The parameters for .foot are the same as for the 
etitle. The default is no footers. 


FILE LINKAGE (.link f£1lename) 


This macro can link text modules together as a single printable 
document. An example is .link d26 “SECTION14". Simply enter the 
link macro at the bottom of the file immediately before the one you 
want loaded and processed. Thus the first file would have a .link to 
the second, the second to the third, etc. There is no limit to the 
number of files which can be linked. 


RUNNING MACHINE LANGUAGE PROGRAMS (.ru $xxxx) 


This macro allows the user to run a machine language program at 
any point during the text formatting process. This is helpful when 
it is desired to send command strings to the printer to change the 
character set, to perform elongated printing, etc. The machine 


language program issues the command string and performs an RTS. back 
to the MAE. The text processing then continues with no indication of 


the interruption. 


PRINTING TEXT ~ )WC and )WP 


Normally )RU $A00 is used to send STP output to the CRT, and )RU 
$A03 1s used to send the output to the printer. The STP also 
contains an initialization routine at $A06 which provides two new 
commands. After the initialization routine is run by typing )RU 
$A06, the )WP command can be used to send STP output to the printer 
and )WC can be used to sem it to the CRT. 


When the )WP and )WC commands are performed, the .link macros 
are ignored unless specifically asked for by typing )WP LI. 
Additionally, the first n pages may be suppressed by typing WP LI n 
or )WP n. These options can also be used with the )WC command. 
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CREATING SHAPE TABLES (.shape n and .set nl p) 


The STP Word Processor has provisions for printing text in 
various shape formats by using a table to control the right and left 
margins. The .shape macro is used to define the shape to be_ used. 
Shape 1 is in the form of an 'I' and entered by simply entering the 
command .shape 1 at the beginning of the text file. 


The .shape 2 macro may be used to create a user defined shape. 
In order to define the desired shape, .set macros are used to make 
entries in the user shape table corresponding to the desired shape. 
The parameters in the .set n1 p are as follows: 


n = line number for this margin specification 
1 = column for left margin start 
p = number of characters to be printed on this line 


For example, .set 14 5 40 defines line 14 as left margin starts 
in column 5, and there are 40 characters to be printed on this line. 


Normally one would have to enter 66 set macros to complete the 
user shape table. But it should be noted that .set 0 1p is a 
special case. The 0 (which would normally represent the line number) 
indicates that all lines in the file are set to a left margin of 1 
and print width of p. This is useful as you can set all lines in the 
user shape table to a particular margin and then use non 0 values to 
change certain lines to form the desired shape. 


Note: Always enter the .shape 2 macro before the .set macros. 
The reason is that as soon as the -.shape 2 macro is 
encountered, it fills the user shape table to default 
values of left margin = 0, and print width = 40. Thus 
if you enter .set macros first, they will be 
overwritten by the .shape 2 defaults of O and 40. 


If .shape 2 is entered and no shape commands are entered, the 


margins will default to .m 0 40. This is very useful when it is 
desired to view the formatted output on the Apple's 40 column screen. 


DEFAULT CONDITIONS 


The following are a number of assumed defaults that exist on 
initial entry to the word processor. 
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Justification = on 

Shaping = off 

Margins = 66 lines/page, 3 blank lines between text body and 
titles and footers, left margin = 0, and print 
width = 76. 

Vertical Spacing = 1 (single spaced output) 

Paragraph = 1 line down and 5 space indent 

Page Title = page number but no text 

Page Footer = no text or page number 


" HOW TO USE THE STP WORD PROCESSOR 


1) Load the word processor and MAE via: 
BRUN MAE.EXE 
)DC “BLOAD WORDP.EXE" 


2) Clear format mode via )FORMAT CLEAR. 


3). Enter raw text using MAE for editing. Include all 
necessary text processing macros. : 


4) When you are finished entering the raw text and 
associated text macros, generate a formatted output via: 


)RUN SA0O0 -<- for output to CRT only 
)RUN $A03 ~— for output to CRT and Printer 
)RUN $A06 - to initialize output commands )WP and )WC. 
Subsequently, )WP sends STP output to the 
printer, and )WC send it to the CRT. 
Parallel or serial printer driver in MAE 
go is required for this mode of operation. 
\ 
EXAMPLE As 
PLY 
A raw text file named WORDP.INS is contained on the diskette. 
Type )GET “WORDP.&MES to load this file. Type )PRINT to examine the 
raw text with associated macros. Type )RUN $A00 (CRT only) or )RUN 
$A03 (CRT and non-standard Printer) to execute the word processor and 
output the text in word processor format. Note: If you output this 


to a 40 column Apple, it will not appear neat since the margin was 
set for 76 characters per line. 


Now compare the raw text printout with its text macros to the 


formatted output generated by the word processor. Examine these two 
printouts until you are familiar with the function of the STP macros. 
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13. SPECIAL NOTES 


A. Converting Eastern House ASSM/TED Files to MAE Files 


(1) Use usual procedure to enter MAE. 
(2) Use )SET to allocate the necessary space for file to be converted. 
(3) Use )BR to enter monitor. 
(4) Clear text file area as follows. 
*3000:0 (first byte of text file = 00) 
*3001<3000.4FFCM (all bytes = 00) 
Note that this example uses bounbaries $3000 - S4FFC. This step 
should be changed to agree with your boundairy settings. 
(5) Warm start MAE (*5003G) 
(6) BLOAD old ASSM/TED file from disk 
)DC “BLOAD Snn.file,A$xxxx" (xxxx = current start of text file) 
(7) Type )PR / to list last line. 
(8) Return to monitor with )BR. 
(9) Move contents of $76E4 and $76E5 to $76DA and $76DB. 
(10) Warm start MAE (*5003G). 
(11) Save new MAE file using )PUT command . 


B. Editing Basic Programs With MAE 


Wouldn't it be nice to be able to use the copy, move, 
search/replace, and auto line numbering features of the MAE to edit 
BASIC programs? Well, it can be done. 


The editor cannot tell the difference between assembly language, 
text such as you are now reading, and BASIC instructions. However, 
the Apple DOS EXEC command is the thing that makes this idea 
possible. The text can be created with MAE's editor and then saved 
as a text file on the disk. When the program is to be executed, 
simply type EXEC “textfilename” from BASIC and the program will be 
loaded from disk and executed. Before running the program in this 
manner, you should type NEW in order to remove any BASIC program 
currently residing in RAM. If this is not done, the text file 
program will be appended to or overlaid on the existing progran, 
depending on the line numbers of the two programs. 


The TEXTOUT.EXE program is used to create the text file when the 
BASIC program has been completed and is still in the MAE text area 
(the text file boundaries must begin at $3000). You just type )DC 
“BLOAD TEXTOUT.EXE” and then )RU $805. The TEXTOUT.EXE program will 
ask you for a name for the output text file (it must be limited to 20 
characters). When the name has been entered and followed by a 
RETURN, the TEXTOUT.EXE program will begin loading the text from 
MAE's text area into a sequential text file on the disk. The line 
numbers are converted from the packed- BCD form (low byte first) used 
by the MAE, to ASCII and stored with the most significant digit 
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stored first. Additionally, leading zeros of the line number are 
deleted. The instruction is then stored until the end-of-line byte 
is found (this is determined by testing bit 7 for 1). 


After each line is stored, the next line is tested for 
end-of-file. If the third byte of the line (first byte following the 
line number) is 00, then all data has been saved and the text file 
can be closed. The TEXTOUT.EXE program will then return to the MAE... 
You may then type )BA or CTRL-B to exit to BASIC in order to test the 
text file program. 


The text file can be reloaded into the MAE by typing )DC “EXEC 
filename”. This allows for subsequent editing of the source program. 


When the BASIC program is complete and tested, it can be saved 
as a regular BASIC program or RUN once it has been EXECed into RAM 
From basic. 


C. Converting MAE Files To and From Other Assemblers 


The TEXTOUT program can also be used to transfer MAE assembler 
files to another assembler which requires text-file source code. In 
order to transfer source files from another assembler to the MAE, the 
text File created by the other assembler can be EXECed into the MAE 
as previously described. If the other assembler does not store line 
numbers in the source file, the other assembler must be used to 
initiate auto line numbering in the MAE. This is done by making the 
first line of the file “auto 10” and the second line “0” (the quotes 
are for emphasizing the line, they should not actually be typed in 
the text file). 


D. Miscellaneous Notes 


# When entering source modules (without .EN), you can perform 
a short test on the module by assembling the module while 
in the text file and watching for the !07 error. If 
other error messages occur, you have errors in the 
module. This short test is not a complete test but does 
check to insure you have lined up the fields properly, 
not entered duplicate labels within the module, or 
entered illegal mnemonics or addressing modes. 


® MAE's internal software UART resides in locations $7303-$7406. 
* An 80 character/line output device should be used when 


printing an assembly listing in order to provide a neat 
printout without foldover to the next line. 
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® If you are going to use MAE and Basic together, alter 
HIMEM ($9073, $0074) so Basic will not clobber MAE, 
or its text or label files. 


# Use quality diskettes like SCOTCH or DYSAN. A few 
dollars saved on a cheap diskette is not worth the 
risk of lost data. 


* We recommend that a naming convention for your files 
be established. We use the following extensions: 


name.CTL Control File 

name .Mxx Module referenced in Control File 
name.ASM Source file without .CT 
name.EXE Executable object file 
name.REL Relocatable object file 
name.MAC File containing all Macros 
name.LIB Library of symbols 
name.MLIB Library of Macros 

name.DOC Program Documentation 
name. INS User instructions 

name.NOT Program Notes 

name. BAS Basic Program 

name.DAT Basic Data File 


* The MAE can be configured for use with 80-column cards 
such as the Sup'R'term card. If you have one of these 
cards, make the following patches to the MAE and then 
resave it (BSAVE MAE,A$5000,L$2C90) 


(1) Insert NOPS (SEA) es locations $7A4B-$7A4D. 

(2) At $7A55 insert 220 7C 

(3) At $7C90 insert :A9 8C 20 ED FD A9 98 20 ED FD 60 
This provides the HOME command for Sup'R'tera but 
may also be used for other 80-column cards. 

(4) At S68BE insert :4E 


NOTE: You may also want to make the changes to the STP as 


shown in Part 12 so that the 80—column/lower case card can 
be used for text processing. 


14. ASSM/TED USERS GROUP 
An ASSM/TED Users Group has been formed by James Strasma for the 


exchange of programs and unique modules. Most of the information in 
this exchange is oriented to PET MAE but should soon contain sose 
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Apple MAE compatiable software. The cost per diskette is also 
minimal but the information is extremely useful. For more details, 
cont act: ; 


James Strasma 

c/o Grace U.M.C. 

120 West King Street 
Decatur, Ill. 62521 


15. HOW TO CONFIGURE FOR PRINTER 


If you are using an Apple parallel or Centronics or Tymac 
parallel printer card, you will want to change the printer driver 
internal to the MAE. This can be done very easily by typing )AS 
“PARL.OUT” . This file is included on the MAE disk and can be 
modified to use the interface card in any slot (see comments in 
PARL.OUT file). If you are using the card in slot number 1, no 
modification is required. In that case, all you need to do is type 
)DC “BLOAD PARL.OUT.EXE”. In either case, you should resave the MAE 
when the printer driver has been loaded or assembeled. This is done 
by typing )DC “BSAVE MAE,A$5000,L$2C90". When this change has been 
made, the printer can be activated by typing )TO P and deactivated by 
typing )TO A. Also, )RU $A03, or )WP can then be used to send STP 
output to the printer. 


If you are using a non-standard printer interface (i.e. one 
which does not work via PR#n), you may either use the provided 
non-standard printer driver or substitute your own. In any case to 
turn on the non-standard printer, type )TO PRINTER. To turn off, 
type )TO APPLE. 


The non-standard printer driver provided within MAE is designed 
to be utilized with an RS232 parallel to serial interface card such 
as the one provided by Electronic Systems Co., and the Heathkit H14 
printer. This printer driver is set up to operate with the serial 
interface card in slot 0. Just in case this is not compatiable with 
your system, we have provided a listing of the printer driver which 
you can use reconfigure for your requirements. The listing is 
provided in Part 16. 


16. EXAMPLE LISTING 
A listing of the Applesoft mem progran, non-standard printer 


driver, and an example UART prograa in MAE's syntax is contained in 
this section. 
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The UART program is a software UART driver contained on the 


supplied diskette under files: UART.CTL, UART.MO1, UART.MO2, and 
UART .MO3. 


The UART driver program has three entry points: 


1) SET.BAUD - Optional entry used to automatically measure user 
terminal baud rate. 

2) UART.OUT - Output character in R(A)- 

3) UART.IN - Input character and return in R(A). 


Note: The UART program is free to use by MAE purchasers for any 
non-commerical purpose. For commerical use, we only request 
that you briefly write describing the use of the UART progran. 
We request no monetary payment or any other renumeration. 
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6616 CT ‘DESIGNATE AS CONTROL FILE 
0626 
8636 CE CONTINUE IF ERRORS 
0648 | 
8856 BA $2688 
0068 
0678 ; 4444444 DEFINITIONS #4444444 
6888 , : 
6698 FIA.PORT .DE $E84! ‘PIA DATA PORT 
0168 PIA.DIR  .DE $843 sPIA DIRECTION PORT 
8118 
6128 MSK.IN DE 461680688 *INPUT IS ON BIT 6 
0138 MSK.OUT  .DE 410800080 sOUTPUT IS ON BIT 7 
6148 
6156 
8168 ;UART CONTROL PARAMETERS: 
8178 ; 
6188 
2668- «8198 NO.PADBITS .0S 1 "NO. OF PAD BITS ON CR LF 
0208 
2661- 6218 BIT.TIME .DS 1 | ‘BAUD RATE CODE (8-7) 
8226 ; Sica entecar: Semen aaNet 
8238 ; = 118 +: 4= 2406 
6248 ; 1= 306 : 3 = 4880 
8258 ; 2= 606 +: 6= 7206 
8268 ; -3= 1200 : 7 = 9608 
6278 
0288 
8298 
0308 FI D16 "UART.M61° ;SET BAUD AND TABLE DELAYS 


07F6 432D-4B23 UART.M@1 


8818 
6828 ; #4444 SET BAUD RATE +4444 
8638 | 
2882- 88 6848 SET.BAUD PHP sSAVE PSR 
2003- 78 8658 SE] ‘CLEAR INTERRUPTS 
2084- AD 43 EB 8848 LDA PIA.DIR sINITIALIZE PORT ON LOGON 
2667- 29 BF 6678 AND NSFF-MSK.IN a 


| ' 
2009- 89 86 0068 ORA SK OUT : ] 
266B- 8) 43 E8 8696 STA PIA.DIR ; i 
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0108 
200E- 20 47 28 8118 LPI 
2011- D8 FB sa1.28 
2013- AD 41 £8 8138 LP2 
2016- 29 48 8148 
2018- FO F9 08158 
281A- AG 88 «8168 
201C- AD 41 E8 6178 LP3 
201F- 29 48 9188 
2021- F887 ~—s-_:«81 98 
2023- CO FF 0200 
2025- FA FS 6218 
2827- C8 8228 
2028- DB F2 $8238 SKP.FF 
0248 
282A- 98 8258 GOT.COUNT 
282B- AQ 00 0260 
2020- 09 3F 28 6278 LP.FI 
2030- 8803 0288 
2032- C8 0298 
2033- D0 FR 430s 388 
2035- 8C 61 28 6318 GOTBAUD 
2030- A2 OC —ss«a8328 
203A- 20 BE 28 8330 
2030- 28 0348 
203E- 60 6358 
| 0360 
8378 
203F- FF 8388 TBLBAUD 
2048- 93 8398 
2041- 4A 0408 
2042- 25 0418 
2043- 12 0428 
2044- 6A 8438 
2045- 07 9448 
2046- 88 0458 
8468 
0478 
2047- AD 41 £8 0488 GET.BIT 
204A- 29 48 0498 
204C- 60 6508 
0510 


2040- AD @1 28 0520 DELE.5 


35 
JSR GET.BIT 
BNE LPI *BR. IF ALREADY SPACING 
LDA PIA.PORT 
AND RMSK.IN 
BEQ LP2 ‘BR. JF MARKING 
LOY #88 CLEAR FOR DELAY FACTOR 
LDA PIA.PORT *GET BIT 
AND #4SK.IN . $ 
BEQ GOT. COUNT 
CPY #$FF 
BEQ LP3 
INY 
BNE LP3 
TYA "MOVE COUNT T0 R(A) 
LOY #88 
CMP TBLBAUD,Y 
BCS GOTBAUD 
INY 
BNE LP.FI 
STY BIT. TIME ‘STORE BAUD RATE CODE 
LOX #12 WAIT UNTIL ALL BITS HAVE 
JSR PAD.DELX 
PLP 
RTS 
eBY 259 . = 118 
«BY 147 : = 368 
«BY 74 : = 600 
BY 37 + = 1200 
BY 18 > = 2400 
BY 18 : = 4808 
«BY 7 ' = 7288 
»BY @ : = 9688 
LDA PIA.PORT *GET KEYBOARD INPUT 
AND #4SK.IN : # 
RTS 


LOA BIT. TINE 


2850- 18 
2051- 08 
2052- 49 08 
- 2054- AB 
2055- 4C 5B 20 


2058- AC O1 28 
2058- B9 64 20 
205E- FO 16 
2040- Ag 
2061- 88 

2062- D8 FD 
2064- EA 

2065- 48 


2666- 88 
2067- 86 
2868- 88 
2669- 9A 
284A- 47 
286B- 10 
206C- BF 
286D- 88 


206E- 68 
206F- 86 
2676- 68 
2671- 48 
2672- IF 
2673- 8A 
2674- 83 
2675- 81 


--2876- BY SBC 28 
2079- AB 

207A- 48 48 4g 
2070- 48 49 48 
2088- 48 

2081- 468 68 68 
2084- 468 68 48 
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8886 NOT.THIS 
g98 
6908 LOOPDEL2 


0918 


8530 cic 
8540 CLO 

8550 ADC #98 

8540 TAY 

4570 JMP EN@.5 
8588 

8598 DLYFULL LOY BIT.TINE 
0660 ENB.S «LDA ‘UD. TBLI,Y 
0610 BEQ NOT.THIS 
8620 TAY 

0638 LOOPDEL! DEY 

0648 BNE LOOPDEL! 
8650 NOP 

8440 RTS 

8678 

04688 3---DELAY=5X+19 

8490 UD.TBLI BY 88 

8786 BY 80 

0710 BY 08 

6728 ,BY 154 

4730 BY 71 

8748 BY 29 

0750 ‘BY 15 

8760 .BY 08 

8770 

8780 +---DELAY=5X+28 

8798 BY 00 

0888 BY 80 

8816 BY 06 

0828 BY 72 

8838 BY 31 

0840 BY 18 

8858 BY 83 

Tr BY 01 

8878 


LDA UD.TBL2,Y 
TAY 


sDELAY FULL FOR 118 BAUD 


‘DELAY FULL FOR 388 


(sDELAY FULL FOR 686 


sDELAY FULL FOR 1206 
sDELAY FULL FOR 2468 
sDELAY FULL FOR 4888 
DELAY FULL FOR 7208 
sDELAY FULL FOR 9668 


i 
# 
# 
# 
# 
# 


sDELAY 8.9 FOR 116 BAUD 


‘DELAY @.5 FOR 300 
‘DELAY 6.5 FOR 480 
‘DELAY @.5 FOR 1208 
sDELAY 8.5 FOR 2408 
‘DELAY @.5 FOR 4808 
‘DELAY @.5 FOR 7200 
‘DELAY 6.5 FOR 9600 


-BY $48 $48 $48 $48 $48 $48 $48 


BY $68 $68 $68 $68 $48 $68 $68 


- 
3g 
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2087- 68 
2088- 88 4928 DEY 
2089- D8 EF 0938 BNE LOOPDEL2 
2088- 40 0948 RTS 
9958 : 
8940 ;---DELAY=54x#22 
288C- A? 8978 UD.TBL2 BY 147 ‘DELAY FULL FOR 118 BAUD 
2880- 3C 4980 BY 68 ‘DELAY FULL FOR 388 # 
208E- 1E 8998 BY 38 ‘DELAY FULL FOR 608 # 
200F- 60 80 80 1088 .BY 06 60 60 00 08 
2092- 66 88 
1018 
1828 3---DELAY=54X+3! 
2094- 53 1030 BY 83 -DELAY @.5 FOR 118 BAUD 
2095- 1€ 1048 BY 38 ‘DELAY 8.5 FOR 300 # 
2096- 8E 1050 BY 14 ‘DELAY @.5 FOR 480 # 
0318 FI 016 “UART.NO2* ;UART OUTPUT DRIVER 


0343 4320-4678 UART.N82 


0618 
0020 ; +4444 UART OUTPUT +4444 
8638 
2097- 88 0648 UART.OUT PHP 
2698- 78 6658 SE] 
2099- 28 9E 28 80468 JSR UART.OUT! 
269C- 28 0678 PLP *RESTORE PSR AND RETURN 
209D- 68 0086 RTS 
8098 
~ 209E- 48 0186 UART.OUT! PHA sSAVE CHAR. 
209F- 49 FF ss 118 — EOR 4SFF s INVERT 
28A1- 48 0128 PHA 
20A2- A2 6B 6138 LOX #11 311 BITS: 1 STOP, 8 DATA, 
28A4- 38 0148 SEC 
26A5- 28 02 28 8158 LP.UOUT JSR BIT.OUT ‘BIT TO PORT 
20A8- 28 58 28 8168 JSR DLYFULL sDELAY FULL BIT TIME 
28AB- 68 6178 PLA sRESTORE R(A) 
28AC- 4A 0188 LSR A ‘NEXT BIT 
26AD- 48 0198 PHA "AND SAVE 
2BAE- CA 0200 DEX 
26AF- 06 F4 6210 BNE LP.UOUT sLOOP 


20Bi- 68 0228 PLA ;REMNOVE JUNK 


2882- 68 

2683- 29 7F 
28B5- CY @D 
20B7- FB 8B 
28B9- CY BA 
26BB- Fe 87 
20BD- 68 


28BE- 48 
20BF- E86 88 
20Ci- 4C C8 28 


20C4- 48 

26C5- AE 88 28 
26C8- FB 86 
26CA- 28 58 28 
26CD- CA 

26CE- DB FA 
2008- 68 

26Di- 48 


2602- AD 41 £8 
2005- 29 7F 
2007- 96 @2 
2609- 89 88 
260B- 8D 41 E8 
200E- 66 


02368 

6248 

0258 

6268 

8278 

0288 

0298 

8388 

0318 PAD.DELX 
0326 

8338 

6348 : 

0358 PAD.DEL 
0366 

0378 PAD.DELEN 
6388 LP.PDEL 
0396 

8408 

0418 EX.DEL 
8428 

0436 

6448 BIT.OUT 
0458 

8468 

0478 

8488 SKP.BOUT 
8498 

8566 

6518 

8326 


6248 4320-4575 UART.M@3 


200F- 88 

26E8- 78 

26E1- AY 86 
20£3- 48 
2064- 28 47 268 
20£7- DO FB 


8010 
8020 ; 
8838 
0048 UART.IN 
0658 

0060 

8070 

0080 LP.UI! 
0098 
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PLA 

AND #$7F 
CMP #80 
BEQ PAD.DEL 
CMP #$8A 
BEQ PAD.OEL 
RTS 


PHA 
CPX #08 
JMP PAD. DELEN 


PHA 

LOX NO.PADBITS 
BEQ EX.DEL 

JSR OLYFULL 
DEX 


BNE LP.POEL 


PLA 
RTS 


LDA PIA.PORT 


AND #SFF-NSK.OUT 


BCC SKP.BOUT 
ORA MSK.OUT 
STA PIA.PORT 
RTS | 


sRESTORE CHAR. 
‘CLEAR BIT 7 
‘CR 


sLF 


*PRESERVE 

‘GET # OF PAD BITS 
SKIP IF ZERO 
sDELAY 


LOOP 
*RESTORE 


sPUT BIT 


«FT 016 "UART.M83° s;UART INPUT DRIVER 


$4444 UART INPUT 44444 


PHP 

SE] 

LDA #06 

PHA ; | 
JSR GET.BIT 
BNE LP.UI! 


sCLEAR CHAR. 


GET BIT 
SLOOP UNTIL NO BIT 


20E9- 26 47 26 
20EC- F@ FB 


28EE- 28 40 28 
20F1- 28 47 28 
20F4- 38 

20F5- 08 81 
20F7- 18 
20F8- 68 

20F9- 6A 
20FA- B@ 87 
26FC- 48 
28FD- 28 38 26 
2188- 18 
2181- 96 EE 
2103- 49 FF 
2165- 29 7F 
2187- 28 
2168- 68 


END OF MAE PASS! 


--- LABEL FILE: 


BIT.OUT =2802 
DLYFULL =2658 
END.PGM =2189 
GOT .COUNT =282A 
LOOPDEL2 =207A 
LP.UI1 =20E4 
LP.UOUT =2805 
LP3 =281C 
NO.PADBITS =2000 
PAD.DELEN =28C8 
PIA.PORT =E841 
SKP.FF =2628 
UART.IN =28DF 
UD.TBLI =2866 
//9000 2109, 2189 
) 
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8108 

6118 LP.UI2 JSR GET.BIT 
8128 ~ BEO LP.UI2 
8138 

8148 JSR DELO.S 
8150 LP.UI3. JSR GET.BIT 
0148 SEC 

8178 BNE SKP.UI! 
8180 CLC 

a198 SKP.UI1 PLA 

6288 ROR A 

8218 BCS DONE.UI 
8228 PHA 

8230 JSR OLYFULL 
8248 CLC 

8258 BCC LP.UI3 
8248 DONE.U] EOR #SFF 
8278 AND #37F 
0288 PLP. 

8298 RTS 

8338 

6348 

8350 

8340 END.PGN —.EN 


BIT. TIME =2061 
DONE .UI =2183 
EX.DEL =2608 
GOTBAUD =2835 
LP.FI =262D 
LP.UI2 =28E9 
LP1 =206E 
MSK.IN =8648 
NOT. THIS =2076 
PAD.DELX =26BE 
SET BAUD =2082 
SKP.UI1 =26F8 
UART .OUT =2897 
UD.TBL2 =288C 


sGET BIT 
*LOOP UNTIL START BIT 


DELAY UNTIL MIDDLE OF STA 
GET BIT 
‘ASSUME SPACE 


‘NO IT 1S MARK 


‘ROTATE RIGHT INTO CARRY 


“DELAY UNTIL MIDOLE OF NEX 


‘LOOP FOR NEXT BIT 

* INVERT 

‘CLEAR BIT 7 

*RESTORE PSR AND RETURN 


DEL8.9 =284D 
EN@.9 =265B 
GET.BIT =2647 
LOOPDEL! =266! 
LP.PDEL =286CA 
LP.UJ3 =26F1 
LP2 =2613 
MSK.OUT =6688 
PAD.DEL =28C4 — 
PIA.DIR =E£843 
SKP.BOUT =2808 
TBLBAUD =283F 
UART OUT! =209E 
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MAE SUPPLIED NONSTANDARD PRINTER DRIVER 


(DESIGNED FOR ELECTRONIC SYSTEMS SERIAL INTERFACE AND HEATH Hi4 PRINTER) 


3928 5 

3938 5 
7BAD- 48 3948 PROUT = PHA sSAVE THE CHAR. 
7BAE- AD 86 CB 93956 WAIT! LOA $C888 = ; CHECK RS-232 INPT FOR BUSY 
7BB1- 29 83 3968 AND #903 sMASK OUT HI NIBBLE 
7BB3- C9 81 3978 CNP #98! s($11=NOT BUSY) 
7BB5- 08 F? 3988 BNE WAIT! | 
7BB7- AD 81 C8 3998 WAIT2 LDA $C681 = ;CHECK UART STATUS 
7BBA- 6A 4068 ROR A (BIT 7) 
7BBB- 96 FA 4018 BCC WAIT2 
7BBD- 68 4020 PLA sRESTORE CHAR. 
7BBE- 8D 82 C6 4038 © STA $C882 = ;SEND IT TO RS-232 OUTPUT = 
7BCi- 68 4048 EXIT RTS 


26 


36 
46 


38 


68 


88 
98 


MAE MENU LISTING (APPLESOFT BASIC) 


HOME :0$ = CHRS$ (64); PRINT TABC 6)"MACRO ASSEMBLER/EDITOR (MAE)°: PRINT 
TAB( 12)°APPLE 1] VERSION" ! 

PRINT : PRINT TAB( 13)°COPYRIGHT 1986° 

PRINT TAB( 9)"EASTERN HOUSE SOFTWARE’: PRINT : PRINT : PRINT : PRINT 
: PRINT "ENTER CODE FOR DESIRED FUNCTION’: PRINT 

PRINT " A = ASSEMBLER/EDITOR (MAE)": PRINT ° R = RELOCATING LOADER’: 
PRINT " W = MAE AND WORD PROCESSOR’: PRINT ° B= BASIC’: PRINT ° 
M = MONITOR" 

PRINT : PRINT : PRINT : INPUT A$: IF A$ = °A® THEN PRINT DS"BRUN MAE. 
EXE": END 

JF A$ = "R® THEN PRINT DS$"BRUN RELOC.EXE*: END 

IF A$ = °B° THEN END 


106 JF A$ = °"M" THEN CALL - 15! 

182 IF AS < > "W° THEN 26 

165 PRINT D$*BLOAD MAE.EXE": FOR X = 1 TO 1600: NEXT X 
187 PRINT D$*BLOAD WORDP.EXE": CALL 20468 


ERROR CODE 


1B 
1A 
19 
18 
17 


ZRROR CODES 


DESCRIPTION 


eEN in non .CT file when .CT file exists. 
-EN missing in .CT designated file. 
Found .FI in non .CT file. 


Checksum error on disk load. 
Syntax error in )ED command. 


Multiple .CT assignment. : 

Command syntax error or out of range error. 
Missing parameter in )NU command. 

Overflow in line # renumbering. 

CAUTION: You should properly renumber the 
the text file for proper command operation. 
Overflow in text file - line not inserted. 
Overflow in label file - label not inserted. 
MAE expected hex characters, found none. 
Illegal character in label. 

Unimplemented addressing mode. 

Error in or no operand. 

Found illegal character in decimal string. 
Undefined label (may be illegal label). 

-EN pseudo op missing. 

Duplicate label. 

Label missing in .DE or -DI pseudo op. 

eBA or .MC operand undefined. 

Illegal pseudo op. 

Illegal mnemonic or undefined macro. 

Branch out of range. 

Not a zero page address. 

Error in command input. 


Overflow in file sequence count (2**16 max.) 
Overflow in number of macros (2**16 max.) 


eME without associated .MD 
Non-symbolic label in SET pseudo op. 
Illegal nested definition. 


Macro definition overlaps file boundary. 
Duplicate macro definition. 

Quantity parms mismatch or illegal characters. 
Too many nested macros (32 max.) 

Macro definition not complete at .EN 
Conditional suppress set at .EN 

Macro in expand state at .EN 

Attempted expansion before definition. 


